crop
Type
command
Summary
Trims an image.
Syntax
crop <image> to <left>, <top>, <right>, <bottom>
Description
Use the crop command to remove parts of an image, or to extend the image's edges.
The crop command changes the image's rectangle property to the new rectangle. Unlike changing the rectangle directly, the crop command removes image data outside the new rectangle, instead of scaling the image to fit.
If the crop rectangle is smaller than the image's original rectangle, the parts of the image outside the crop rectangle are removed. This is a permanent operation; the cropped portions do not reappear if you use the crop command to change the image's rectangle back to the original size.
If the crop rectangle is larger than the image's original rectangle, blank pixels are added to one or more edges of the image.
The crop command cannot be used on a referenced image. Doing so will cause an execution error.
Parameters
| Name | Type | Description |
|---|---|---|
image | Any image reference. | |
left | The left, top, right, and bottom describe the new rectangle of the image. | |
top | ||
right | ||
bottom |
Examples
crop image 1 to 100,100,200,200
crop image "photo" to the rect of graphic "Overlay"
Related
glossary: property, referenced control, command, execution error
object: image
property: pixels, imageData, rectangle
Compatibility and Support
Introduced
LiveCode 2.0
OS
mac
windows
linux
Platforms
desktop
server
mobile